home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Amiga Amateur Radio User Group / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].zip / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].adf / DisView / ASYSTAT < prev    next >
Text File  |  1995-05-21  |  3KB  |  73 lines
  1. =======                                             DISview [518]
  2. asystat
  3. =======
  4.  
  5. ________________________________________________________________
  6. asysyat
  7. ________________________________________________________________
  8. Display statistics on attached asynchronous communications
  9. interfaces (8250 or 16550A).  The display for each port consists
  10. of three lines.
  11.  
  12. >> Example of output from 'asystat':
  13. ................................................................
  14. sl0: [NS16550A] [trigger 0x7e] [rlsd up] 38400 bps
  15.  RX: 741 int, 7454 chr, 0 hw over, 48 hw hi, 0 fifo TO, 
  16.                                             0 sw over, 186 sw hi
  17.  TX: 274 int, 3648 chr, 0 q, 1 MS int, 0 THRE TO
  18. ................................................................
  19.  
  20. The first line gives the port label and the configuration flags;
  21. these indicate whether the port is a 16550A chip, the trigger
  22. character if any, whether CTS flow control is enabled, whether
  23. RLSD (carrier detect) line control is enabled, and the speed in
  24. bits per second.  (Receiving the trigger character causes the
  25. driver to signal upper layer software that data is ready; it is
  26. automatically set to the appropriate frame end character for
  27. SLIP and PPP lines.)
  28.  
  29. The second line of the status display shows receiver (RX) event
  30. counts: the total number of receive interrupts, received
  31. characters, receiver overruns (lost characters) and the receiver
  32. high water mark (HWM).
  33.  
  34. The HWM is the maximum number of characters ever read from the
  35. device during a single interrupt.  This is useful for monitoring
  36. system interrupt latency margins as it shows how close the port
  37. hardware has come to overflowing due to the inability of the CPU
  38. to respond to a receiver interrupt in time.
  39.  
  40. 8250 chips have no FIFO, so the HWM cannot go higher than 2
  41. before overruns occur.  The 16550A chip, however, has a 16-byte
  42. receive FIFO which the software programs to interrupt the CPU
  43. when the FIFO is one-quarter full.
  44.  
  45. The HWM should typically be 4 or 5 when a 16550A is used; higher
  46. values indicate that the CPU has at least once been slow to
  47. respond to a receiver interrupt.
  48.  
  49. When the 16550A is used, a count of FIFO timeouts is also
  50. displayed on the RX status line.  These are generated
  51. automatically by the 16550A when three character intervals go by
  52. with more than 0 but less than 4 characters in the FIFO.  Since
  53. the characters that make up a SLIP or PPP frame are normally sent
  54. at full line speed, this count will usually be a lower bound on
  55. the number of frames received on the port, as only the last
  56. fragment of a frame generally results in a timeout (and then only
  57. when the frame is not a multiple of 4 bytes long).
  58.  
  59. Finally on the second line, the software FIFO overruns and HWM
  60. are displayed.  These indicate whether the <bufsize> parameter on
  61. the 'attach' command needs to be adjusted.
  62.  
  63. The third line shows transmit (TX) statistics, including a total
  64. count of transmit interrupts, transmitted characters, the length
  65. of the transmit queue in bytes, the number of status interrupts,
  66. and the number of THRE timeouts.  The status interrupt count will
  67. be zero unless CTS flow control or RLSD line control has been
  68. enabled.  The THRE timeout is a stopgap measure to catch lost
  69. transmit interrupts, which seem to happen when there is a lot of
  70. activity (ideally, this will be zero).
  71.  
  72. For more information on interpreting the output from the
  73. 'asystat'command, see the KA9Q Tuning FAQ.